---
id: troubleshootissue
title: Issue
---

## 一、什么是Issue

Issue是GitHub、Gitee等上用于记录问题、bug、任务、需求等的地方。

## 二、为什么使用Issue

Issue实际上是一系列与仓库有关的讨论集合，它可以用来记录问题、bug、任务、需求等。他和QQ、微信等不同，它是一个公开的讨论区，任何人都可以参与讨论。同时，还可以搜索到前人的讨论，方便我们学习。

同时，他也是像邮件一样，具有低频交流的特性，这就使得不管是提问还是解答，都得描述的相较仔细。且最好图文并茂。大大减少无效交流。

## 三、如何使用Issue

首先，目前我们只支持Gitee的Issue功能，所以请先注册一个Gitee账号。

然后在[TouchSocket Issues](https://gitee.com/RRQM_Home/TouchSocket/issues) 连接下，新建Issue即可。

<img src={require('@site/static/img/docs/troubleshootissue-1.png').default} />

:::tip 提示

在填写时，请尽可能的描述清楚现状，及其他一切有关信息。最好能提供可运行测试的demo。

:::  

:::caution 警告

未按格式提供的Issue，会被直接关闭。一般建议使用电脑端编写。因为我们已经为大家写好了相关模版。

:::  


## 四、提供Issue有关的Demo

在Issue中，我们强烈建议提供可运行的demo，这样可以帮助我们更快的定位问题。

提供的方式**仅限下列git仓库**，其余途径均不受理。

- [TouchSocket Demo](https://gitee.com/RRQM_Home/publicworkbook)

### 4.1 Fork仓库

首先，点击Fork，将仓库克隆到自己的名下。

然后，在仓库中，新建一个文件夹，名称按照序号，依次递增，要求不重复。然后在此文件夹中新建一个demo解决方案，就是能直接编译运行的。

<img src={require('@site/static/img/docs/troubleshootissue-2.png').default} />

### 4.2 提交

当建立好demo后，将demo提交到自己的仓库中。请确定此Demo可以脱离环境编译并运行。

### 4.3 合并PR

在提交以后，在gitee上，点开自己Fork的仓库，然后点击`Pull Request`，`新建Pull Request`。

<img src={require('@site/static/img/docs/troubleshootissue-3.png').default} />

然后注意，选择目标分支为`RRQM_Home/publicworkbook=>master`。同时，请填写相关信息。

<img src={require('@site/static/img/docs/troubleshootissue-4.png').default} />

最后，所提的Issue中，提供此demo的链接。
